home *** CD-ROM | disk | FTP | other *** search
/ Nebula 2 / Nebula Two.iso / SourceCode / MiscKit1.7.1 / MiscKit / Palettes / MiscGaugePalette / MiscGaugeView.subproj / MiscGaugeCell.h < prev    next >
Encoding:
Text File  |  1995-04-14  |  3.9 KB  |  128 lines
  1. /****************************************************************************
  2.   CLASS:                MiscGaugeCell
  3.   INHERITS FROM:        Cell
  4.   PROGRAMMER:            Todd Thomas, Copyright 1995
  5.   DATE BEGAN:            March 09, 1995
  6.   LAST CHANGED:            March 21, 1995
  7.   VERSION:                0.4
  8.   CHANGES:                See the end of the implementation file.
  9.   
  10.   This class takes care of everything needed to display a gauge. It 
  11.   should also be pretty easy to use your own gauge face and hand in
  12.   a subclass by overriding drawHand:flipped: and drawFace:. See the
  13.   documentation for more details.
  14.   
  15.   We inherit from Cell (and not from SliderCell or ActionCell)
  16.   because I thought gauges were basically for showing values, not
  17.   altering them. 
  18.   
  19.   The guts of this class originally came from the GaugeView in the 
  20.   BusyBox example located in /NextDeveloper/Examples/Appkit. I
  21.   basically copied the code here, changed the pswraps to allow for
  22.   color, changed the method names and used inherited cell methods,
  23.   and replaced the cache window with an NXImage.
  24.   
  25.   See the implementation file for the original comments that came
  26.   with the GaugeView. (I suppose you could also find it in the 
  27.   /NextDev/Examples directory).
  28.  
  29.   This object is included in the MiscKit by permission from the author
  30.   and its use is governed by the MiscKit license, found in the file
  31.   "LICENSE.rtf" in the MiscKit distribution.  Please refer to that file
  32.   for a list of all applicable permissions and restrictions.  
  33.  *****************************************************************************/
  34.  
  35. #import <appkit/Cell.h>
  36.  
  37. @class NXImage;
  38. @class Font;
  39.  
  40.  
  41. @interface MiscGaugeCell : Cell
  42. {
  43.     NXImage *cache;                // Cache for non-moving display of gauge.
  44.     Font *titleFont;            // Font of the title. (Numbers use cell's font)
  45.     short titlePosition;        // Either NX_ATTOP or NX_ATBOTTOM.
  46.     float radius;                // Radius of gauge face.
  47.     NXPoint center;                // Center of gauge face.
  48.     float startAngle;            // Angle in degrees where the min value is.
  49.     float angleRange;            // Range in degrees which hand spans.
  50.     float degreesPerUnit;        // Ratio of degrees to units. 
  51.     int tickInterval;            // Interval of tick marks on gauge face.
  52.     float tickRatio;            // Tick radius in ratio to face radius.    
  53.     float handRatio;            // Length of hand in ratio to face radius.
  54. //    NXColor backgroundColor;
  55.     NXColor gaugeColor;
  56.     NXColor textColor;
  57.     float minValue;
  58.     float maxValue;
  59.     float value;                // Current value of the gauge.
  60.     char *strValue;                // Used in stringValue.
  61. }
  62.  
  63. + initialize;
  64. - init;
  65. - free;
  66.  
  67. - (float)maxValue;
  68. - (float)minValue;
  69. - (float)floatValue;
  70. - (double)doubleValue;
  71. - (int)intValue;
  72. - (const char *)stringValue;
  73.  
  74. - setMaxValue: (float)max;
  75. - setMinValue: (float)min;
  76. - setFloatValue: (float)val;
  77. - setDoubleValue: (double)val;
  78. - setIntValue: (int)val;
  79. - setStringValue: (const char *)val;
  80.  
  81. - (float)startAngle;
  82. - (float)angleRange;
  83. - (int)tickInterval;
  84. - (float)tickRatio;
  85. - (float)handRatio;
  86.  
  87. - setStartAngle:(float)newValue; 
  88. - setAngleRange:(float)newValue; 
  89. - setTickInterval:(int)newValue; 
  90. - setTickRatio: (float)newRatio;
  91. - setHandRatio: (float)newRatio;
  92.  
  93. //- (NXColor)backgroundColor;
  94. - (NXColor)gaugeColor;
  95. - (NXColor)textColor;
  96. //- setBackgroundColor: (NXColor)color;
  97. - setGaugeColor: (NXColor)color;
  98. - setTextColor: (NXColor)color;
  99.  
  100. //- (float)backgroundGray;
  101. - (float)gaugeGray;
  102. - (float)textGray;
  103. //- setBackgroundGray: (float)gray;
  104. - setGaugeGray: (float)gray;
  105. - setTextGray: (float)gray;
  106.  
  107. - titleFont;
  108. - setTitleFont: newFont;
  109. - (const char *)title;
  110. - setTitle: (const char *)newTitle;
  111. - (int)titlePosition;
  112. - setTitlePosition: (int)newPos;
  113.  
  114. - calcCellSize: (NXSize *)size inRect:(NXRect *)rect;
  115.  
  116. - drawSelf: (const NXRect *)rect inView: controlView;
  117. - drawInside:(const NXRect *)cellFrame inView:aView;
  118. - drawHand: (const NXRect *)rect flipped: (BOOL)viewFlipped;
  119. - drawFace: (const NXRect *)rect;
  120. - highlight:(const NXRect *)cellFrame inView:aView lit:(BOOL)flag;
  121.  
  122. - awake;
  123. - read: (NXTypedStream *)stream;
  124. - write: (NXTypedStream *)stream;
  125.  
  126. @end
  127.  
  128.